The Elder Scrolls IV OBLIVION:

================================
More Realistic Encumbrance v2.21
--------------------------------
by Mentalor & Bayli
================================

1.  Requirements
2.  Installation
3.  Playing the mod
4.  Saved games
5.  Description
6.  Change Log
7.  Future Plans
8.  Conflicts / Known Errors
9.  Credits
10.  Contact and Information
11.  Legal Stuff / Disclaimer


================
1.  REQUIREMENTS
================
Oblivion v1.1.0.511 or higher
Oblivion Script Extender 0013 or higher (Get the latest version at http://obse.silverlock.org)


================
2.  INSTALLATION
================

For new users:

1.  Ensure you are using a saved game where your carried weight is about half that of your maximum allowed weight.  i.e.  if your maximum allowed weight is 200lb you should be carrying around 100lb.
2.  Extract the files into your Oblivion\Data folder.
3.  Start Oblivion.
4.  Select the More Realistic Encumbrance plugin in the Data Files section.
5.  Start Oblivion...have fun.

For upgrading users:

1. Start the game with the OLD version still in place.
2. Ensure that you are carrying about half your maximum allowed weight and that you are not fatigued...do a New Save.
3. Exit the game, uncheck the mod in Data Files and start the game again,
4. Load the save you made in 2., allowing the game to continue when it errors after you start it (the error is normal)
5. Make another New Save and exit.
6. Install the upgraded mod and check it in Data Files.
7. Start game and load save made in 5.
8. Make ANOTHER New Save and continue playing...AFTER testing the mod until you are happy it does what it says on the tin.


===================
3.  PLAYING THE MOD
===================
Should work by itself.


===============
4.  SAVED GAMES
===============
The mod should be fully compatible with old save games.  Just make sure you are carrying about half your maximum allowed weight and that you are NOT ENCUMBERED OR FATIGUED when you un/install the mod and everything should be fine.


===============
5.  DESCRIPTION
===============
Wasn't it funny that your character could carry full steel plate armor and few swords, but after picking up 1 little strawberry he suddenly gets crushed under the mighty weight of his inventory?  Well, this mod fixes that by altering the character's performance depending upon how encumbered the character is.

Now, by the power of OBSE, More Realistic Encumbrance makes all Fatigue and Stat adjustments smoothly...no more jumps in encumbrance as you pick up more stuff...unless you pick up a lot of stuff at once that is.  If you only pick up small amounts at a time only small adjustments will be made.

The Shinji Encumbrance Bonus is for those players who carry very little equipment...they will gain bonuses to stats and Fatigue regeneration.  Fighting naked just got an advantage.

Athletics, Acrobatics and Sneak skills will increase more quickly if you run, jump, swim, hide or pick-pocket whilst encumbered, fatigued or Shinji.  The harder you push yourself, the higher the rewards will be.

Sound is now included as an audible indicator of your physical stress level...getting louder and faster the more stress you put yourself under.



Encumbrance Effects
-------------------
*** Shinji Encumbrance Bonus
When carrying less weight than this Athletics-based threshold (see Calculations below) your Fatigue will recover quicker.  You will get bonuses to Speed, Agility, Sneak and Acrobatics (the maximum possible bonus increases based on your Willpower)...also Athletics, Acrobatics and Sneak skills will increase upto twice as fast as when carrying 'normal' weights.  The less you carry, the bigger the bonus.

*** Unencumbered
When carrying weights between the thresholds for Shinji Bonus and Slight Encumbrance you will be not be affected by any encumbrance related stat adjustments and skills will increase at a normal rate.

*** Slight Encumbrance
When carrying more than this Endurance-based threshold, initially, your Fatigue will regenerate slower...but as you approach your maximum allowed weight, Fatigue will begin to slowly drain away.  The maximum amount your Fatigue can regenerate to will fall and you will get drains to your Speed, Agility, Sneak and Acrobatics.  On the bright side, because of the extra skill involved in moving whilst encumbered Athletics, Acrobatics and Sneak skills will increase upto twice as fast as when carrying 'normal' weights.

*** Great Encumbrance
When your carried weight goes over your maximum allowed weight you will be allowed to (attempt to) carry more.  Your Fatigue will drain faster, your maximum fatigue will fall further and the drains on your stats will be more severe.  The especially hardy, more athletic type, may attempt to attain Athletics, Acrobatics and Sneak experience in excess of 3 times quicker than under 'normal' weight conditions...however, carrying a hearty selection of Restore Fatigue potions is highly recommended before undertaking such activity.  Eventually, because of the various drains experienced you will simply be too fatigued to stand up and will fall over.  You will then need to either drop something or take a Feather potion, though sometimes a Restore Fatigue potion may be enough to get you standing again...breifly.



Fatigue Effects
---------------
This part of the mod tweaks the way that Fatigue functions.  Fatigue will now be lost whilst running and also whilst casting spells.

*** Out of Breath
When your Fatigue drops below this Athletics-based threshold, you will become Out of Breath and will lose Speed, Agility, Sneak and Acrobatics.  The longer you are out of breath, the bigger the drain on your stats will be.  Because of extra skill involved in moving whilst fatigued Athletics, Acrobatics and Sneak skills will increase upto twice as fast as when unfatigued.

*** Exhaustion
If you reach 0% Fatigue you will probably collapse, exhausted.

*** Recovery
Once you have been Out of Breath, your stats will take a few seconds to return to normal.  Get those Restore Stamina potions ready!



Calculations
------------
Now for the science bit...probably best skip this section if you don't like equations!

*** Shinji Encumbrance Bonus
The weight at which the Shinji Encumbrance Bonus starts is calculated by the formula:

	Shinji Threshold = 'normal' max weight * (0.05 + (Athletics / 1000))

The maximum Shinji Stat Bonus is simply:

	Max Bonus = Willpower / 10

Whilst under the Shinji threshold your Fatigue will regenerate upto 50% faster.  This is based solely on how much you are carrying.


*** Encumbrance
The weight at which Slight encumbrance occurs is calculated by the formula:

	Slight encumbrance Threshold = 'normal' max weight * (0.75 + Endurance / 1000))

Once you reach Slight encumbrance any extra weight you pick up will lower your Fatigue regeneration limit (allowing Oblivion to handle the effects of low Fatigue).  The amount your regen limit is lowered by is calculated per extra lb picked up using the formula:

	Fatigue per lb = (200 - Athletics) / 100

The rate at which Fatigue regenerates will decrease per lb picked up based on the formula:

	Fatigue Regen per lb = ((fFatigueReturnBase * 1.5) / (Max Weight - (MaxWeight * 0.75))) * -1

fFatigueReturnBase is the GMST upon which Oblivion bases how fast Fatigue regenerates.  The calculation returns a value which means that when you get to roughly 90% your maximum encumbrance Fatigue drain will equal Fatigue regen.  From then on, your fatigue will start to slowly drain away until you fall over.

The Amount your stats will drop by is calculated per lb by:

	Stat Adjustment Per lb = ((40 - (Strength / 5)) / (Max Weight - Slight Threshold)) * -1


*** Fatigue
The percentage at which you become Out of Breath is calculated as 30 - (Athletics / 5) percent



Settings
--------
MRE now includes More Realistic Encumbrance.INI, which contains many MRE settings and instructions on how to change them.  In game, the Encumbrance Configuration Ring will be added to your inventory when you first start using the mod.  This ring will allow you to turn certain MRE functions on and off.  There is also the ability to reset MRE to the current INI file.  This should be used to make your game reflect any changes you have made to MRE.INI, as the INI file is only automatically read when you first start the mod...not everytime you load a game.



==============
6.  Change Log
==============
v2.21
* Minor code adjustments to hopefully sort out a couple of problems

v2.2
* Added More Realistic Encumbrance.INI to allow editing of many MRE settings
* Added Encumbrance Configuration ring to allow in game modification of some settings
* Added sounds to the different levels of fatigue / encumbrance
* Added Blur At Max Weight option (was missing from when v1 was re-written)...also made it the default
* Added a second blur pulse to make it a bit more heartbeat like (can be turned off)

v2.1
* Added skill experience increases when the character is 'under stress'...the more stressed, the bigger the increase.

v2.02
* Fixed problem with formula to calculate how much Attributes should be affected by Fatigue...Endurance + Willpower / 10 was being calculated as (Willpower / 10) + Endurance rather than (Endurance + Willpower) / 10.

v2.01
* Added ability to turn off the debug text

v2.0
* All Scripts have been almost completely rewritten to allow for a far smoother application of stat adjustments
* Shinji Encumbrance Bonus added for the particularly unencumbered players with high Athletics

v1.0
* Incorporated Fatigue mod into MRE to allow better integration (ESP choices are now with and without Fatigue)
* Added ability to toggle blur on and off from the console
* Added ability to only start showing blur when max weight is reached (rather than before, when slight encumbrance starts)
* Fixed incorrect Fatigue regen limit adjustment calculation which used GetBaseActorValue instead of GetAV
* Fixed error in going to moderate encumbrance from slight encumbrance when Fortify Strength was removed
* Fixed omission of Fatigue regen limit loss when Fortify Strength was removed

v0.91
* Renamed to avoid parenthesis
* Updated credits

v0.9
* Added optional ESP with screen blur effect
* Adjusted Slight encumbrance threshold

v0.82
* Adjusted Fatigue drains to fit better with the More Realistic Fatigue ESP.
* Removed MRE Fixer ESP from the zip file.
* Included v0.71 ESP file and readme for those who like more weight allowance (Now called More Capacity Encumbrance).
* Added More Realistic Fatigue ESP & readme.

v0.81
* Weakness to Normal Weapons removed.
* Speed / Agility drains re-added.
* Fatigue regen limit now affected by the lb.
* Changed some variables from shorts to floats (hopefully sorts out a few things).
* Changed fQuestDelayTime to 0.75 hopefully stopping the stutters that have been seen.
* Various code clean-ups and fixes

v0.8
* Mainly used to fiddle with a few ideas...nothing worth releasing.

v0.7
* All attribute / skill drains removed.
* Fatigue regen limit applied at each encumbrance level (-15% per level).
* Weakness to Normal Weapons Disease added (shakey-screen effect required, me thinks)
* Updated Installation instructions.
* Updated Conflicts / Known Errors (nothing serious).
* Updated Credits & Permissions.

v0.61
* All armour skill drains have been removed.
* Added skill drains for all weapons (Blade, Blunt, H2H & Marksman).
* Added Acrobatics skill drain.
* Changed attribute / skill drains from Abilities to Diseases.

v0.6
* Will now jump multiple encumbrance levels if you have picked up / dropped enough weight, rather than iterating through each level to get to the one you are at.
* Messages cleaned up a bit.
* Couple of minor bug fixes.

v0.51a
* Minor bug fix

v0.51
* Strength now affects carrying capacity too.
* Minimum extra carrying capacity is now 1.

v0.5
*Added Willpower affecting carrying capacity
*Cleaned up code a bit

v0.45 
*Thanks to the great help from Mentalor from TESsource forums some bugs got fixed and code is more dynamic now
*The yoyo problem where player stood up from the crushed state is now fixed too and player stays down if fatigue goes below  and unless player removes some stuff from inventory. 

v0.41
* From the major remake due to excessive fatigue and tiredness I forgot the debug boxes in there, this just removes them  leaving them only there if you're going beyond overload and when you remove enough stuff to get to overload state.

v0.4 
* Cleaned up the script not to be so "dangerous", because it earlier modified the stats directly which caused problems 
* Now uses spell effects to modify stats, much safer this way, has 4 different effects (light, moderate, heavy encumbrance  and overload) (check above for more info)
* Added Drain skill to Sneak, Light Armor, Heavy Armor and Hand-To-Hand each at different strength at different encumbrance  levels (check above for more info)
* Overload and crushing levels now damage your health and your fatigue (check above for more info)
* If player goes beyond overload, he's now crushed under the mighty weight of inventory, don't stick there too long though,  it's hard to breath under tons of stuff. 
* Added a fixer esp to the package in case someone wants to update to newer version, but has problems with the previous one.  Read instructions from part 3 of this readme, "Installing the plugin"

v0.2
Cleaned up version that does what it's supposed to do (NOTE: well.. actually didn't, at least for some users)

v0.1a
Initial test version (not released)


================
7.  Future Plans
================
- If someone gives us good ideas on how to balance this or otherwise make it even better, We'll be glad to improve it. 

- Let us know at: http://www.bethsoft.com/bgsforums/index.php?showtopic=786087


============================
8.  CONFLICTS / KNOWN ERRORS
============================
May Conflict with mods such as Vim & Vigour which also alter the Oblivion Fatigue system.  May also conflict with other encumbrance mods.


===========
9.  CREDITS
===========
All work by us.

v2.2	Thanks to Jaga Telesin and Donovan Baarda for the sctripting tutorials that are, respectively, Streamline 3 and Realistic Fatigue
v2.1	Thanks to dttnbguy for the experience suggestion
v1.0	Thanks to Draiden for suggesting configurably turning blur off for slight encumbrance and Strategy Master for the coding discussion
v0.9	Thanks to eikka for the screen blur suggestion
v0.81	Thanks to hughesdylan and Negative_Creep for the scripting tutorial that is Survival Suite HTS, it has shown the way on several things...as well as adding loads of depth to the game.
v0.7	Thanks to kalniel for reminding us Oblivion will reduce skills automatically if you are fatigued.
v0.61	Thanks to Polycrates for the info on different spell types...that sorted out a couple of problems.

Big thanks to Mentalor, since he has single-handedly updated the mod from 0.45 onwards, the current version wouldn't have  been at our hands without him. Great work!

(Thats OK Bayli, if you hadn't started it in the first place, I wouldn't have picked it up and ran with it  -Mentalor-)


============================
10.  CONTACT AND INFORMATION
============================
Mod created by Pauli Laatikainen aka Bayli < pplaat (at) utu (dot) fi > and Ian Barton aka Mentalor < mentalor (at) ntlworld (dot) com >


=============================
11.  LEGAL STUFF / DISCLAIMER
=============================
Please feel free to share this plugin. Just dont take credit for it!

We take no responsiblity for any damage done to your gaming experience by using this mod.
